Inside Macintosh: Mac OS 8 Toolbox Reference /

Chapter 3 - Window Manager Reference / Window Manager Functions

Displaying Windows /

DrawGrowIcon

CHANGED WITH THE APPEARANCE MANAGER

Draws a window's size box.

pascal void DrawGrowIcon (WindowPtr theWindow);

theWindow

On input, a pointer to the window structure.

DISCUSSION

When you adopt Appearance directly, you never need to call the DrawGrowIcon function to get a size box in your window. You can still use DrawGrowIcon to draw the delimiting scroll bar lines, if you wish.

If you are going through the mapping layer, however, you do need to call DrawGrowIcon, but only once, because under Appearance, once DrawGrowIcon is called, the size box is merged into the window's frame.

The DrawGrowIcon function doesn't erase the scroll bar areas. If you use DrawGrowIcon to draw the size box and scroll bar outline, therefore, you should erase those areas yourself when the window size changes, even if the window doesn't contain scroll bars.

WHEN THE APPEARANCE MANAGER IS NOT AVAILABLE

The DrawGrowIcon function draws a window's size box or, if the window can't be sized, whatever other image is appropriate. You call DrawGrowIcon when drawing the content region of a window that contains a size box.

The exact appearance and location of the image depend on the window type and the window's active or inactive state. DrawGrowIcon automatically checks the window's type and state and draws the appropriate image.

In an active document window, DrawGrowIcon draws the grow image in the size box in the lower-right corner of the window's graphics port rectangle, along with the lines delimiting the size box and scroll bar areas. To draw the size box but not the scroll bar outline, set the clipRgn field in the window's graphics port to be a 15-by-15 pixel rectangle in the lower-right corner of the window.

In an inactive document window, DrawGrowIcon draws the lines delimiting the size box and scroll bar areas and erases the size box.